package com.briup.appointment.config;
import io.swagger.v3.oas.models.OpenAPI;
import io.swagger.v3.oas.models.info.Contact;
import io.swagger.v3.oas.models.info.Info;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class Knife4jConfig {

    /**
     * 自定义 OpenAPI 文档信息（核心配置，确保版本字段正确生成）
     */
    @Bean
    public OpenAPI customOpenAPI() {
        return new OpenAPI()
                .openapi("3.0.1") // 添加必需的OpenAPI版本字段
                // 文档基础信息
                .info(new Info()
                        .title("Spring Boot 3 + Knife4j API 文档")
                        .description("使用 Knife4j 增强的 OpenAPI 3.0 文档示例")
                        .version("v1.0.0")
                        // 可选：联系人、许可证信息
                        .contact(new Contact().name("开发者").email("dev@example.com"))
                );
    }
}